home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / bbs / winpoint.zip / PSORT.ZIP / PSRT.DOC < prev    next >
Text File  |  1994-01-18  |  11KB  |  251 lines
  1.   ┌──────────────────────────────────────────────────────────────┐
  2.   │    DOS USERS:                                                │
  3.   │                                                              │
  4.   │ If you do not have DOS4GW.EXE, you will need to get a copy.  │
  5.   │ It is available on my system (1:203/7707 or 1:203/8055) as   │
  6.   │ DOS4GW.ZIP.  This is the same DOS extender being used for    │
  7.   │ utilities such as BlueWave, GoldEd, etc as well as many of   │
  8.   │ the newer games like Doom by ID Software..                   │
  9.   └──────────────────────────────────────────────────────────────┘
  10.   If you do not have DOS4GW.EXE in this archive, get it!
  11.  
  12.   Fidonet file request:  1:203/7707 or 1:203/8055, name: "dos4gw.zip"
  13.  
  14.   Internet email: email "fileserv@wmeonlin.sacbbx.com", message body
  15.   "get dos4gw.zip".
  16.  
  17.  
  18.  
  19. PSRT - Packet filter & sorter
  20.  
  21.   - Requires 386sx or greater
  22.  
  23.   - Requires 1 meg of extended/ems/dpmi/vcpi/whatever memory
  24.     (more memory provides better sorting, ideally, 3-3.5 megs :-)
  25.  
  26.   - Requires DOS4GW.EXE, a special dos extender for Watcom C++ applications
  27.  
  28.   - Disk space:  Lots.  See below for a better answer.
  29.  
  30.   - Reads and combines .PKT files into one large .PKT file (multiple
  31.     .PKTS if from multiple sources; the PKT headers themselves are
  32.     preserved for security).
  33.  
  34.   - Reads according to .PKT file time/date stamp order (ie, older
  35.     packets will be processed first, then the newer ones).
  36.  
  37.   - Sorts by area, subject, date, and time, up to the limits of memory
  38.     (ie, the more memory you have, the more that can be contiguously sorted)
  39.  
  40.   - If AREAS.BBS found (standard AREAS.BBS format), it will be read,
  41.     and _only_ the areas found in AREAS.BBS will be kept.  Useful if
  42.     you get the entire backbone but only need a portion of it, ie
  43.     satellite feeds.
  44.  
  45. To run:  see below, _AFTER_ reading these other sections.  Violaters
  46. will be assimulated, resitance is useless...
  47.  
  48. "What advantage will running this do for me?"
  49.  
  50.     PSRT has more than one purpose.. It's original design was to be a
  51.     speed-up for my mail processor.  Squish, Jam, and *.MSG users will
  52.     notice the biggest speed increase, as it won't have to open and
  53.     close each message base nearly as often.  On my particular setup,
  54.     PSRT doubles my speed with Squish, and even makes Gecho noticable
  55.     faster than normal.
  56.  
  57.     Secondly;  PSRT sorts by subject and time/date.  This means that
  58.     all of the messages for a given subject will be grouped together,
  59.     which facilitates reading.  When I get interested in one topic, I
  60.     hate to have to jump all over the message base to follow it.  Also,
  61.     I see the original messages, BEFORE the replies, because of the
  62.     time/date sort.  Really handy with the lag time of fidonet
  63.     technology.
  64.  
  65.     Last, is a feature I myself will never use, but was a 15 minute fix
  66.     to add in.  Satellite options such as "PLANET_CONNECT" give you the
  67.     entire backbone, even if you only want 50-100 of the areas.  Not
  68.     too many mail tossers handle this very gracefully.  PSRT will read
  69.     your AREAS.BBS (if it's in the current directory), and ONLY output
  70.     the files that are in the areas you want, and throws the rest of
  71.     them away.
  72.  
  73.     _Some day_, this might actually become a mail tosser (minus message
  74.     base), for those only interested in moving the mail, and not
  75.     reading it.  However, this is a lower priority, as this utility as
  76.     it is already speeds up mail tossing significantly.
  77.  
  78. "(Hubs)  What advantage will running this do for my feeds?"
  79.  
  80.     If you sort YOUR inbound files out, then, for the most part, the
  81.     output of your mail processor will also be sorted,
  82.     making things work faster for your downlinks.  They would be able
  83.     appreciate the same speedup that you do.  They will also be amused
  84.     at 4:00am seeing it toss alphabeticly.  :-)
  85.  
  86. "How much disk space will I need?"
  87.  
  88.     PSRT will read in as much as possible into memory, and then write
  89.     it all back out to disk.  It will NOT delete the input files until
  90.     AFTER it has successfully written the files to disk.  If there's a
  91.     problem, the program will abort.
  92.  
  93.     What this means, is if you have 1 meg of free (extended/etc) memory
  94.     at startup, you'll need about a meg of disk space.  If you have 8
  95.     megs of ram, you may need as much as 8 megs of disk space.
  96.  
  97.     Worst case scenario, you'll need as much disk space free as you
  98.     have tied up in all of your .PKT files.
  99.  
  100. "My [deity/exclamation of choice]!  Why so much memory?"
  101.  
  102.     PSRT is an DOS-extended mode application.  That's 32-bits for the
  103.     gizmo freaks.  You're going to need at least a meg to make things
  104.     run cleanly, but not much sorting will be possible, unless you're
  105.     an end-node with a light-to-medium load.
  106.  
  107.     Btw: the types of memory that are usable under the DOS4GW extender
  108.     are:  Extended, XMS, EMS, DPMI, and VCPI.  That's about everthing,
  109.     folks.  Just make sure it's available.  That dos extender may be a
  110.     big one compared to most, but it is also one of the most thorough -
  111.     and works fine under DV, OS/2, Windows, and of course, DOS.
  112.  
  113. "What about OS/2?"
  114.  
  115.     Jeff Dunlop has graciously ported the packet sorter to OS/2.
  116.     It's not video-intensive at all, and will for the most part mirror
  117.     the changes I make to the DOS version.  Any questions/etc will be
  118.     forwarded to him.
  119.  
  120. "Will you add XXXXX feature?"
  121.  
  122.     Maybe, but probably not right away.  This packet sorter is a quick
  123.     and dirty utility that provides two specific functions (AREAS.BBS
  124.     filtering, and AREA sorting).  I don't plan on turning this into a
  125.     major product.  That's why it's _free_ - you get what you pay for.
  126.     I don't plan on adding fancy logging, automatic decompression, or
  127.     kitchen sinks.
  128.  
  129. To run:
  130.  
  131.     Uncompress any mail bundles that you may have.  GUS is a good
  132.     program for this; there are alternatives.
  133.  
  134.     If desired, copy your current AREAS.BBS to the directory where
  135.     your .PKT files are.  If found, it will only keep areas that are
  136.     defined in AREAS.BBS.
  137.  
  138.     Run PSRT.EXE in the same directory as your .PKT's.
  139.  
  140.     Here's my config..
  141.  
  142.   ┌────────────────────────────────────────┐
  143.   │ cd \bbs\gecho                          │  Generate a current AREAS.BBS
  144.   │ gsetup areas c:\bbs\inbound\areas.bbs  │  from my Gecho configuration
  145.   │                                        │
  146.   │ cd \bbs\inbound                        │  De-archive all of my inbound
  147.   │ gus .\ /m                              │  mail archives to .pkt files
  148.   │                                        │
  149.   │ PSRT.EXE                               │  Sort + filter the packets
  150.   │                                        │
  151.   │ cd \bbs\gecho                          │
  152.   │ gecho toss scan pack                   │  Toss the mail!
  153.   └────────────────────────────────────────┘
  154.  
  155.  
  156. Registration, support:
  157.  
  158.     Cost:       Nothing.  Perhaps, a netmail "thanks".
  159.     Support:    Nothing.  Unless you're nice about it, and I have time.
  160.     Guarantee:  Satisfaction guaranteed, or your money back.  Good
  161.                 thing it's free, he? :-)
  162.     Donations:  Gladly accepted.
  163.     Updates:    Probably often.  File request "PSORT.ZIP" from
  164.                 1:203/7707.  If you need the DOS extender, file request
  165.                 "DOS4GW.ZIP".
  166.  
  167.     I don't expect to make this a fancy wiz-bang menu-driven program
  168.     with fancy setup.  I would end up spending 75% of my time working
  169.     on that stuff, instead of working on the actual tool.  If you don't
  170.     like this program, you're not obligated to run it.
  171.  
  172.     Fidonet:     Jason Fesler, 1:203/7707
  173.     Internet:    jfesler@wmeonlin.sacbbx.com
  174.     Compu$pend:  >INTERNET:jfesler@wmeonlin.sacbbx.com
  175.  
  176.     Re: OS/2 version of PSORT ..
  177.  
  178.     Fidonet:     Jeff Dunlop, 1:203/16
  179.     Internet:    Jeff.Dunlop@dbsoft.wmeonlin.sacbbx.com
  180.     Compu$erve:  >INTERNET:Jeff.Dunlop@dbsoft.wmeonlin.sacbbx.com
  181.  
  182.     Any netmail sent to me will have their replies _routed_ back unless
  183.     you specifically request me to leave it on hold.  If you do not get
  184.     a response with a reasonable amount of time, it can be that I can
  185.     not route mail back to you; if this is the case, send your message
  186.     again, and ask me to leave it on hold.
  187.  
  188.     I answer _all_ netmail/email that I receive.
  189.  
  190. History:
  191.    Jan 14 1994
  192.        Now reads .PKT files in date/time order (ie, when you
  193.        have 10-20 packets from the same source to process).
  194.        Tweeked subject sorting to work better on gated internet
  195.        newsgroups.
  196.    Dec 15 1993
  197.        First version, sorts on area,subject,date/time
  198.    Dec 29 1993
  199.        Added AREAS.BBS option
  200.    Jan 05 1993
  201.        Finished direct video options; reads directory of .PKT's before
  202.        running main portion of program, builds a table of pkt headers.
  203.        Cuts down on processing time by not redundantly re-reading the
  204.        same headers over and over.  (Mainly for _large_ amounts of
  205.        mail, ie people who sort the outbound before packing it up to
  206.        their downlinks).
  207.  
  208.        Adding in ability to use user-defined extension instead of
  209.        .PKT, ie .QQQ or .OUT.
  210.    Jan 08 1993
  211.        Now making use of the DOS portion of memory.
  212.  
  213.        Read + Write buffering is hard-set to 32k, which is a good value
  214.        for DOS to function with, without double-buffering things to the
  215.        protected mode environment.  Seems to have sped things up by
  216.        about 20% this way.  (Tip obtained from someone else on the
  217.        internet, wasn't _my_ idea! - seems to work, noticably faster!)
  218.  
  219.        Qsort algorithm being used now; also made custom string
  220.        comparison functions so that I can keep smaller indexes (16
  221.        bytes versus 134..).   Net result?  More room for messages;
  222.        much faster sorting; even faster reading messages in.
  223.  
  224.        For my system, performance has improved significantly, from 50
  225.        messages per second to 85 messages per second.  This is with all
  226.        disk caching turned off.
  227.  
  228.    Jan 14 1994
  229.        Now reads .PKT files in date/time order (ie, when you
  230.        have 10-20 packets from the same source to process).
  231.  
  232.        Tweeked subject sorting to work better on gated internet
  233.        newsgroups.
  234.  
  235.        Fixed bugs that Jeff Dunlop found while porting the OS/2
  236.        version.
  237.  
  238.    Jan 18 1994
  239.        Got the new OS/2 version from Jeff; rearchiving package and
  240.        making available for file request.
  241.  
  242.        Now checks to see how much extended memory it needs to allocate,
  243.        before actually allocating it.  Stops thrashing on OS/2 when you
  244.        don't need it.
  245.  
  246.        You may specify the maximum amount of memory to use on the main 
  247.        buffer, as well as the AREAS.BBS file to use.  Type PSRT.EXE -? 
  248.        for details.
  249.  
  250.  
  251.